home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / dev / misc / sana2.readme < prev    next >
Text File  |  1992-10-07  |  5KB  |  105 lines
  1. Short: Network architecture standard
  2.  
  3. Path: urmel!Sirius.dfn.de!darwin.sura.net!gatech!swrinde!cs.utexas.edu!qt.cs.utexas.edu!yale.edu!spool.mu.edu!agate!ucbvax!ucdavis!iris
  4. From: dlarson@cbmvax.commodore.com (Dale Larson)
  5. Newsgroups: comp.sys.amiga.announce
  6. Subject: New SANA-II Spec Documents Available
  7. Keywords: Draft for Final Comment and Approval
  8. Message-ID: <10442@ucdavis.ucdavis.edu>
  9. Date: 16 Nov 91 05:48:54 GMT
  10. Sender: operator@ucdavis.ucdavis.edu
  11. Reply-To: dlarson@cbmvax.commodore.com (Dale Larson)
  12. Followup-To: comp.sys.amiga.datacomm,comp.sys.amiga.programmer
  13. Organization: Commodore, Amiga Networking Group, New Siberia Office
  14. Lines: 87
  15. Approved: zerkle@cs.ucdavis.edu
  16.  
  17. [ For those who don't know already, ab20 is the ftp archive site ]
  18. [ ab20.larc.nasa.gov (128.155.23.64).        -Dan Z              ]
  19.  
  20.  From the new documents:
  21.  
  22. ---
  23.  
  24. The SANA-II Network Device Driver Specification is a standard for the
  25. interface to any Amiga networking hardware.  It is a specification for an
  26. Amiga software interface to the data link layer in the ISO 7-Layer Reference
  27. Model of Open Systems Interconnection.  All Amiga network hardware vendors
  28. should supply a SANA-II device driver for their hardware. All protocol writers
  29. should talk to SANA-II device drivers rather than to network hardware.  Any
  30. protocol stack should work with any SANA-II device driver.  The standard has
  31. been kept simple and straight-forward so that SANA-II device drivers should be
  32. easy to write and to use.  They should be highly efficient and have low
  33. resource usage.  Any SANA-II device driver should behave very much like any
  34. other SANA-II device driver.
  35.  
  36. Application writers must not use SANA-II Device Drivers directly.
  37. Applications must use the API provided by the network protocol software the
  38. application supports.  It is hoped that a standard network API for all Amigas
  39. will be made available by Commodore in the near future.
  40.  
  41. This version of the standard addresses issues from the original SANA-II
  42. standard which were raised in the 1991 North American and European Amiga
  43. DevCons as well as in the conversion of existing protocols to the use of the
  44. standard.  This draft reflects several rounds of comments from active
  45. implementors of SANA-II software.  Most of the changes are simplifications and
  46. should be easy to incorporate into any work in progress.  The changes should
  47. make the writing and use of SANA-II drivers much easier.  Commodore's internal
  48. versions of the A2065 and other drivers and the AS225 software package are
  49. currently compliant with this version of the SANA-II spec.
  50.  
  51. This version of the specification is very solid and will stand as final unless
  52. comments containing very compelling objections are received by December 31,
  53. 1991.  All SANA-II device drivers and software utilizing those drivers should
  54. be written to this version of the specification.
  55.  
  56. Distribution of this version of the standard is unlimited.
  57.  
  58. ---
  59.  
  60. The new documents will be distributed in comp.souces.amiga and will be
  61. available from ab20 as:
  62.  
  63.       /usenet/comp.sources.amiga/volume91/devices/sana-ii-nov7/.
  64.  
  65. Similar names on other archive sites.
  66.  
  67. The documents also are or will be available for download from Bix and ADSP and
  68. will be distributed via other Amiga developer support mechanisms.
  69.  
  70.  
  71. Since the document archive was created, a few errata have been noted:
  72.  
  73. ---
  74.  
  75. SANA-II Network Device Driver Specification
  76.  
  77. Errata to Version of November 7, 1991 for Final Comment and Approval
  78.  
  79.  
  80. It is important to test as many SANA-II devices as possible against as much
  81. SANA-II using software as possible.  Commodore is interested in receiving
  82. evaluation and/or beta copies of any SANA-II using hardware and software
  83. developed by third parties, but makes no assurances regarding any testing
  84. which it may or may not perform with such evaluation copies.  Evaluation
  85. copies should go to the same address as standards comments.
  86.  
  87. The include files should list S2_ADDSTATIONALIAS and S2_DELSTATIONALIAS
  88. as invalid commands.
  89.  
  90. The autodocs which indicate that ios2_Type is a pointer to type should
  91. be corrected to indicate that ios2_Type is the type, not a pointer.
  92.  
  93. The CopyToBuff()/CopyFromBuff() autodocs should indicate that the length
  94. to be copied is a ULONG, not a LONG.
  95.  
  96. The word "effect" in the CMD_FLUSH autodoc should be "affect."
  97.  
  98. The beta a2065.device should properly implement CMD_FLUSH.  It does not.
  99.  
  100. --
  101. Please see monthly postings for the disclaimer, the introduction, the charter,
  102. and submission instructions.  Comments to zerkle@cs.ucdavis.edu.
  103. MAIL ALL SUBMISSIONS TO announce@cs.ucdavis.edu (don't auto-post).
  104.  
  105.